home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 051-075 / disk_069 / asm68k / mini.docs < prev    next >
Text File  |  1992-05-06  |  5KB  |  121 lines
  1.  
  2.             Asm68k    68000 Macro Assembler
  3.                 Version 1.0.3
  4.                   Mini-Docs
  5.  
  6. (This file contains only relevant portions covering changes from version 1.0.2.
  7. The Assembler was released with a full set of updated docs as a separate file,
  8. and should be redistributed with them available.)
  9.  
  10.                   Date:  24-Apr-87
  11.  
  12.                    NOTICE:
  13.  
  14.        THIS FILE AND THE PROGRAM IT DESCRIBES ARE COPYRIGHT © 1987,
  15.     W. WESLEY HOWE. ALL RIGHTS RESERVED. A LICENSE FOR USE AND
  16.     DISTRIBUTION WITHOUT PROFIT IS GRANTED TO POSSESSOR OF THIS FILE.
  17.     NO RIGHT OF ALTERATION OF THE PROGRAM OR DOCUMENTATION IS CONVEYED
  18.     WITH THIS LICENSE.
  19.        NO WARRANTY IS EXPRESSED OR IMPLIED HEREIN ON THE SUITABILITY
  20.     OF THIS PROGRAM FOR ANY PURPOSE AT ALL. YOU MUST RELY ON YOUR OWN
  21.     JUDGEMENT AS TO WHETHER THIS PROGRAM WILL OPERATE PROPERLY WITH
  22.     YOUR COMPUTER FOR WHATEVER PURPOSE YOU MAY DESIRE TO USE IT FOR.
  23.  
  24.                  ADDRESS ALL QUESTIONS, COMMENTS OR CRITICISM TO:
  25.  
  26.                   WESLEY HOWE
  27.                    4800 LAKEMONT DR.
  28.                   RALEIGH,  NC  27609
  29.  
  30.    (I may also be found at the Software Distillery's board (919) 471-6436,
  31. MMS at (919) 779-6674 or (919) 772-9176 or (919) 779-5059, or ocassionally
  32. on PLink (OPS833) and CIS (73277,260), although my appearances at the
  33. last two are more erratic.)
  34.  
  35. =============================================================================
  36.  
  37.                 LIMITS:
  38.  
  39.     Available RAM:          1,056,768 bytes maximum heap utilized
  40.     Program size:         78,024 bytes (loaded)
  41.     Minimum free heap:     28,162 bytes
  42.     Total RAM necessary:    106,186 bytes
  43.     Operating System:        AmigaDOS 1.2 (CLI Only)
  44.  
  45. ==============================================================================
  46.  
  47.             Expressions:
  48.  
  49. Program Counter: The symbol * can be used as shorthand for the current
  50. PC (relative offset) under the following criteria:
  51.     1> It is the FIRST (or only) character in an expression or
  52.     2> It is the second half of a binary operator (i.e. after
  53.        a valid math operator, with or without parentheses.)
  54.  
  55.    Expressions that use the * or any symbol that refers to a relative
  56. or external operation may only use plus and minus for math operations.
  57. Any combinations within an expression that result in a value that will
  58. not always generate reliable usage of relative locations will be flagged
  59. with an expression error message.
  60.  
  61. ==============================================================================
  62.  
  63.              Macros:    
  64.  
  65.    One additional feature within Macros is the \@ (backslash followed by the
  66. at character). While the Macro is being expanded, this combination is changed
  67. to a period followed by three decimal digits. These digits increment starting
  68. from zero every time a macro call is made that uses the \@ combination, and
  69. will be used for the duration of that macro (a contained macro call will use a
  70. new number, then when it ends the former macro's number will be used until it
  71. ends. This allows unique symbol names to be generated within the Macro text,
  72. allowing branch instructions to occur. Local (numeric) Labels are effective
  73. within the Macro, but they do not attach to the Macro name, nor are they
  74. canceled by the Macro invocation (unless the invocation line was labeled.) Note
  75. that this sequence is significantly different from the usage in version 1.0.1.
  76.  
  77. ===============================================================================
  78.  
  79.             Release History:
  80.  
  81.    Version 1.0.1 Alpha1.........released 02-Jan-87.
  82.    Version 1.0.1 Beta1..........released 11-Jan-87.
  83.    Version 1.0.1 Beta2..........released 20-Jan-87.
  84.    Version 1.0.1................released 28-Feb-87.
  85.    Version 1.0.2................released 14-Apr-87.
  86.    Version 1.0.3................released 24-Apr-87.
  87.     Changes:     1. Error messages no longer are generated in the case
  88.                 of EXTERN or ENTRY type multiple definitions.
  89.                 More precisely, the second or subsequent usage is
  90.                 ignored.
  91.              2. The counter for \@ has been changed so that it is
  92.                 not incremented unless it is used by a macro. In
  93.                 version 1.0.2, each macro call incremented the
  94.                 counter, causing overflow in large source files
  95.                 before 999 uses. This change should not cause the
  96.                 need for source changes in files that assembled
  97.                 correctly under the previous release, although a
  98.                 reassembly will have different values used.
  99.              3. The expression evaluator has been changed slightly
  100.                 on the rules regarding the use of the '*' op for
  101.                 the PC location. This corrects prior problems in-
  102.                 volving the assembler confusing the two uses that
  103.                 made multiplication fail.
  104.              4. Labels and symbols that begin with a period will
  105.                 now be recognized within expressions.
  106.  
  107. ===============================================================================
  108.  
  109.    A special note of gratitude to various members of ASDF (Amiga Software
  110. Developers Forum), The Software Distillery (whose BLink reduced the many
  111. hours spent relinking the source files during development), and especially
  112. John Toebes, whose offhand remarks unknowingly provided much of the inspiration
  113. to keep going. Also DJ JAMES and KEN S for their work in running down some
  114. of the problems I missed.
  115.  
  116. ===============================================================================
  117.  
  118.             <*|=|*>  THE END  <*|=|*>
  119.  
  120. ==============================================================================
  121.